home *** CD-ROM | disk | FTP | other *** search
/ Mission 3 / Mission 3.zip / Mission 3.iso / tools / worldclk / phwclk.doc next >
Text File  |  1997-03-12  |  8KB  |  220 lines
  1. PH WORLD CLOCK ver 2.1
  2. by William Wong, Mar 1997
  3. ProbeHouse Software
  4.  
  5. "Another brilliant piece of utility from PHSW"
  6.                  - Drovak.
  7.  
  8. "Calling my worldwide Embassies will be easier with this PHSW clock with
  9.  alarm feature"
  10.                  - Clinton
  11.  
  12.  
  13. Introduction
  14. ------------
  15. The PH World Clock is a ST program that will display both the local time
  16. and the time of the place of your selection. Over 50 world major cities
  17. are programmed into the world clock. The day and date of the local time
  18. is display along with the day of the international time.
  19.  
  20. There is also an user definable city for your home town. There is a simple
  21. implementation of Daylight Savings Time.
  22.  
  23. It have a builtin alarm and hourly chime. The alarm will popup a window
  24. which contain your own message or reminder. There are 8 alarms sounds
  25. available for selection.
  26.  
  27.  
  28. Program or Desktop accessory
  29. ----------------------------
  30. PH World Clock is both a GEM program and a Desktop Accessory.
  31. To use as a GEM program, rename extension to .PRG
  32. To use as a Desktop Accessory, rename extension to .ACC
  33. Note: As a DA, for single TOS, you may need to run a normal program
  34.       before it's entry appear in the DA list. However, Alarm still 
  35.       works right from bootup.
  36.       
  37.  
  38. The Display
  39. -----------
  40. The World Clock is displayed in a window. You can move the window around
  41. the desktop with the mouse. The local time is display on the top line and
  42. the city of choice time is displayed on the bottom line.
  43.  
  44. The CLOSER button of the window will close the World Clock. If you are
  45. running World Clock as an desk accessory, the alarm set is still active
  46. when the World Clock window is close. This feature allows uncluttered
  47. screen when working on any GEM program with the alarm activated.
  48.  
  49. The FULLER button of the window will bring up the CONFIGURATION window.
  50. The CONFIGURATION window allows the alarm time, alarm message, alarm on &
  51. off, chime on & off, the alarm sound and user definable city to be set.
  52.  
  53. The window info line provide the following information
  54.  Bell icon = Alarm time.
  55.  Note icon = Chime is on.
  56.  Clock icon= Daylight Savings Time is on.
  57.  Blinker   = Visual to show that it's working.
  58.  
  59.  
  60. Commands
  61. --------
  62. When World Clock is topped (ie the top most window) the following keyboard
  63. keys are active :
  64.    Left/Right cursor - Scroll city time.
  65.    Up/Down corsor    - Scroll local city time.
  66.    A to Z            - Change to city beginning with alphabet.
  67.    ALT- A to Z       - Change to local city beginning with alphabet.
  68.    CTRL-Q            - Quit World Clock.
  69.    CTRL-C            - Open CONFIGURATION window.
  70.    CTRL-I            - PHSW Program name & my address INFORMATION window.
  71.    CTRL-U            - Close windows (except main window use CTRL-Q)
  72.    CTRL-W            - Scroll between CONFIGURATION & INFORMATION window.
  73.  
  74.  
  75. The CONFIGURATION window
  76. ------------------------
  77. The CONFIGURATION window allows the alarm time, alarm message, alarm on &
  78. off, chime on & off, the alarm sound & user definable city to be set.
  79.  
  80. ALARM : Check the tick box to enable it.
  81.     Time: type in the time of the alarm in 24 hours format.
  82.     Msg : type in your message. This message will appear in a window when
  83.           the alarm goes off. Limit to 29 characters only.
  84.  
  85. GLOBAL :
  86.     Chime : Activate the chime when ticked.
  87.     DST   : Daylight savings Time mode is on when ticked.
  88.     SOUND : Select the sound for alarm and chime.
  89.  
  90. LOCAL CITY: (this sets the user definable city)
  91.     City : Enter the city name.
  92.     GMT  : Enter the hours ahead / behind GMT.
  93.            If behind, add a - otherwise a +.
  94.     DST  : Tick if DST affects this city.
  95.  
  96. INFO     : display PHSW signon and how to contact me.
  97. CANCEL   : Cancel the configuration (means no saving done)
  98. OK       : Save the configuration to PHWCLK.CFG.
  99.  
  100.  
  101. Preference
  102. ----------
  103. The preference of World Clock saved are the local, internation city, the
  104. alarm and chime setting.
  105.  
  106. This is saved in a file called PHWCLK.CFG in the root folder of the 
  107. drive where it is started. PHWCLK.CFG is saved automatically by closing
  108. the CONFIGURATION window or quitting the World Clock program. Notice 
  109. that when using as a desk accessory the program nevers quit and so the
  110. configuration is only saved when the OK button is pressed.
  111.  
  112. Please make sure that your current drive is your bootup drive when saving.
  113. If no preference file is found, the local time defaults to Singapore and
  114. international time, the 1st city in the list. The alarm and chime OFF and
  115. the alarm message as "Alarm". The local city is set to LOCAL and +0000 hrs
  116. GMT.
  117.  
  118.  
  119. List of cities in World Clock
  120. -----------------------------
  121. If your city is not listed, let me know the city name, time away from
  122. Greenwich Mean Time (GMT) and sent it to address in next section.
  123.  
  124.    Amsterdam, Ankara, Auckland,
  125.    Baghdad, Bahrain, Bangkok, Barbados, Barcelona, Beirut, Berlin, Bermuda,
  126.    Bombay, Brisbane, Buenos Aires,
  127.    Cairo, Calcutta, Chicago,
  128.    Darwin, Detroit, Delhi, Dusseldorf (CEBit fame),
  129.    Frankfurt,
  130.    Geneva,
  131.    Hong Kong, Honolulu,
  132.    Johannesburg,
  133.    Karachi, Kuala Lumpur, Kuwait,
  134.    Lagos, London,
  135.    Madrid, Mauritius, Montreal, Moscow,
  136.    Nairobi, New York,
  137.    Oslo,
  138.    Paris, Peking, Perth,
  139.    Rangoon, Rio De Janeiro, Rome,
  140.    San Francisco, Singapore, Sydney,
  141.    Teheran, Tel Aviv, Tokyo, Toronto,
  142.    Vancouver, Vienna,
  143.    Warsaw, Washington,
  144.    Zurich,
  145.  
  146.  
  147. Daylight Savings Time (DST)
  148. ---------------------------
  149. DST is handled PH World Clock simply. It knows which city in it's list is
  150. affected by DST. If the current season is DST, then tick the DST checkbox 
  151. in the GLOBAL setting of the CCONFIGURATION. All affected cities will have
  152. it's time increased by 1 hour. For the user definable city, if the DST for 
  153. it is ticked, then DST is also applied to it.
  154.  
  155. Since I do not know when DST season comes into effect for each country, 
  156. PH World Clock cannot automatically determine DST season.
  157.  
  158.  
  159. Alarm Message
  160. -------------
  161. The alram message box is changed into a MODAL dialog box. This is so to
  162. force the user to acknowledge the alarm.
  163.  
  164.  
  165. There is always another Bug
  166. ---------------------------
  167.         or
  168. Oh, that's a feature of this program
  169. ------------------------------------
  170. If you find any bugs in this program, please let me know.
  171. This program was written in Pure C on a VGA, Tos 4.04, 4 Meg Falcon.
  172. PH World Clock was also tested on Tos 4.04, WinX, and MiNT 1.12 as a DA.
  173.  
  174.  
  175. Version changes
  176. ---------------
  177. version 2.1 - Mar 1997
  178.   - Shortcut keys in configuration window.
  179.   - Added user defineable city
  180.  
  181. Version 2.0 - May 1994
  182.   - Date miscalculation on Sunday fixed.
  183.   - Alarm with personal message added.
  184.   - Chime added.
  185.   - 8 sounds for chime and alarm.
  186.  
  187. Version 1.0
  188.   - First public domain release.
  189.  
  190.  
  191. Another Public domain software
  192. ------------------------------
  193. Yes this is another one of PHSW Public domain software. So here it goes
  194. again ...
  195.  
  196.   If you like this software or use it more than 3 times, I expect you
  197.   to show your appreciation by sending me a mail or some useful stuff like
  198.   CDs, magazines (any type that a male would enjoy seeing), US dollars,
  199.   NEW T-shirts, ST hardware or software, Syquest cartdriges (44 Meg please),
  200.   cheque with your proper signature, US dollars, COE, Falcon 030, video
  201.   tapes (as with the magazines), Hi-Fi set and dollar notes.
  202.  
  203.   Please sent all your goodies to -
  204.           William Wong
  205.           CC 5129,
  206.           Blk 990, Bendemeer Road,
  207.           Singapore 339942,
  208.           Republic of Singapore.
  209.  
  210.    Internet : wongck@letterbox.com
  211.    web page : http://www.geocities.com/SiliconValley/6880/phsw.html
  212.  
  213.   If you somehow would like to register this software, please pay in US
  214.   traveller cheque of US$10, signed correctly for outside Singapore or in
  215.   Singapore, S$15. Registered users will get the source code as well as
  216.   the latest version (if any) send to them in a good condition diskette.
  217.   Please include your postal address.
  218.  
  219.   Ciao, Have fun.
  220.